home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / spreads / readws20.arj / READ_WKS.DOC < prev    next >
Text File  |  1993-08-08  |  21KB  |  489 lines
  1.  
  2.  
  3.  
  4.                   Read_WKS, copyright 1991-93 Mountain Software
  5.  
  6.  
  7.  
  8.                                      Read_WKS
  9.                                  (Read Worksheet)
  10.  
  11.  
  12.  
  13.                 Data Extraction Utility for Lotus and Excel files
  14.                                    Version 2.0
  15.                                   August 8, 1993
  16.  
  17.  
  18.  
  19.                                    _______
  20.                               ____|__     |               (R)
  21.                            --|       |    |-------------------
  22.                              |   ____|__  |  Association of
  23.                              |  |       |_|  Shareware
  24.                              |__|   o   |    Professionals
  25.                            -----|   |   |---------------------
  26.                                 |___|___|    MEMBER
  27.  
  28.  
  29.  
  30.  
  31.                     Autodesk Registered Application Developer
  32.                           Novell Professional Developer
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                Jerry Workman, P.E. 
  44.                                1579 Nottingham Road
  45.                                Charleston, WV 25314
  46.                                   CIS 70717,3564
  47.                         Internet 70717.3564@compuserve.com
  48.                               Orders: 1-800-2424-PsL
  49.                             Tech Support: 304-346-9585
  50.                                  FAX 304-744-1785
  51.  
  52.  
  53.         Read_WKS Documentation                                     page 2
  54.         =================================================================
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                 Table of Contents
  61.  
  62.  
  63.  
  64.         I.   U s i n g   R e a d _ W K S  . . . . . . . . . . . . . .   3
  65.              Purpose  . . . . . . . . . . . . . . . . . . . . . . . .   3
  66.              Installation . . . . . . . . . . . . . . . . . . . . . .   3
  67.              Running Read_WKS . . . . . . . . . . . . . . . . . . . .   3
  68.              Limits . . . . . . . . . . . . . . . . . . . . . . . . .   4
  69.              Uses and Suggestions . . . . . . . . . . . . . . . . . .   4
  70.  
  71.         II.  A d d e n d u m  . . . . . . . . . . . . . . . . . . . .   5
  72.              Error Messages . . . . . . . . . . . . . . . . . . . . .   5
  73.              Liability  . . . . . . . . . . . . . . . . . . . . . . .   6
  74.              Author . . . . . . . . . . . . . . . . . . . . . . . . .   6
  75.  
  76.         III. L i c e n s e  . . . . . . . . . . . . . . . . . . . . .   6
  77.              Registration Information . . . . . . . . . . . . . . . .   7
  78.              Definition of Shareware  . . . . . . . . . . . . . . . .   7
  79.              Disclaimer - Agreement . . . . . . . . . . . . . . . . .   8
  80.              Trademark  . . . . . . . . . . . . . . . . . . . . . . .   9
  81.  
  82.         IV.  I n d e x  . . . . . . . . . . . . . . . . . . . . . . .  10
  83.  
  84.  
  85.         Read_WKS Documentation                                     page 3
  86.         =================================================================
  87.  
  88.  
  89.         I.   U s i n g   R e a d _ W K S
  90.         ================================
  91.  
  92.  
  93.         Purpose
  94.         -------
  95.  
  96.         Read_WKS is a very powerful program which is used to extract data
  97.         from Lotus  and Excel  files. The  data can  be formatted  in CDF
  98.         (comma  delimited)  format, fixed  format,  and AutoCAD  AutoLISP
  99.         format, for  use by  other programs,  or for  reporting purposes.
  100.         Read_WKS works alone,  it is not an  add-in to Lotus nor  does it
  101.         require a "print to disk" from Lotus.
  102.  
  103.         Read_WKS reads Lotus  .WKS, WK1, WK3,  and WRK  files as well  as
  104.         Excel XLS  files directly.  The program reads  not only  the data
  105.         (values  and labels)  from  the spreadsheet  file, but  also cal-
  106.         culated  formula values.  Formatting information;  Column widths,
  107.         cell  formats  (eg fixed,  comma,  $, etc),  and  cell alignments
  108.         (left, right, center),  are also read and can be  used in format-
  109.         ting the  extracted  data. Read_WKS  works on  IBM PC  compatible
  110.         computers  running  DOS 3.0  or  higher  with  at least  150K  of
  111.         available memory.
  112.  
  113.  
  114.         Installation
  115.         ------------
  116.  
  117.         READ_WKS.EXE can  be copied to any  directory that is  on the DOS
  118.         PATH and requires no special installation.
  119.  
  120.  
  121.         Running Read_WKS
  122.         ----------------
  123.  
  124.         Read_WKS  operated from the  DOS command line  using switches and
  125.         parameters to control  it's operations. The switches / commands /
  126.         functions are as follows:
  127.  
  128.         Usage: READ_WKS <switches> <filename>.WK1 <outfilename>
  129.  
  130.         The .WK1 extension is assumed and added to <filename> if omitted.
  131.         Use the WK3 or XLS extension to read from those respective files.
  132.         <outfilename> can also be CON, PRN, STDOUT or any DOS device.
  133.         Switches must start  with / or -  and are not case  sensitive but
  134.         must be placed before any file name(s).
  135.  
  136.         /D        Debug diagnostic display
  137.         /R___     Worksheet   Range   or  range   name[default   A1..D25]
  138.                   (eg /RB11..F35 or /RTOTALS),
  139.                   or "*" for the entire worksheet (/R*)
  140.         /A        AutoCAD  LISP  output   (default  output  filename   is
  141.                   ACAD.123)
  142.  
  143.  
  144.         Read_WKS Documentation                                     page 4
  145.         =================================================================
  146.  
  147.  
  148.         /E        AppEnd output to the output file
  149.         /I        Ignore repeating label cells (eg \=)
  150.         /U        Unformatted (maximum precision) output
  151.         /X        eXpanded formatted report  output, no delimiter,  fully
  152.                   formatted
  153.         /S_       Separator / Delimiter character(s) (eg /S;)
  154.         /Q        Quiet, no display except errors
  155.         /P        Password program - register Read_WKS
  156.         /H        Help - This message.
  157.  
  158.         Example: READ_WKS /RC19..F35 MYFILE.WK3 MYFILE.PRN
  159.              Or: READ_WKS /A /R* MYFILE
  160.  
  161.  
  162.         Read_WKS  will  then execute  and  will  prompt for  any  missing
  163.         parameters:
  164.  
  165.         Enter worksheet filename:
  166.  
  167.              Enter     any      valid     DOS      filename     including
  168.              Drive:\path\filename.ext. If no  file extension is specified
  169.              then ".WK1" is  appended. If you  are reading from a  WKS or
  170.              WRK file then you must enter the full filename.
  171.  
  172.         Enter worksheet range, range name, "*" for all cells
  173.         or ? to list defined ranges[default A1..D25]:
  174.  
  175.              Enter  either   a  worksheet   range  in   the  usual   form
  176.              (eg BA34..CL63), or any range name defined in the worksheet.
  177.              You may enter a question mark "?" to list all range names in
  178.              the  selected  worksheet  file.  Enter  an asterisk  "*"  to
  179.              specify the entire worksheet.
  180.  
  181.  
  182.         Limits
  183.         ------
  184.  
  185.         Read_WKS can not read Lotus SQZ files or Excel  Workbooks. If you
  186.         use a different spreadsheet program  (eg Quattro) then save  your
  187.         file as  a .WK1, WK3, or  .XLS file, most  spreadsheets (and many
  188.         other programs) can save in these file formats.
  189.  
  190.         Read_WKS can not recalculate your spreadsheet.  If you use manual
  191.         recalculation then be sure to recalculate prior to saving so that
  192.         formula values will be correctly displayed.
  193.  
  194.  
  195.         Uses and Suggestions
  196.         --------------------
  197.  
  198.         You can  use your  favorite spreadsheet program  as a  data entry
  199.         form,  and later extract that data for  use in other programs, or
  200.         for consolidation using Read_WKS.
  201.  
  202.  
  203.         Read_WKS Documentation                                     page 5
  204.         =================================================================
  205.  
  206.  
  207.         You can use a simple batch file (see the file LOOP.BAT) to "loop"
  208.         through  a group  of files  (perhaps  all files  in a  directory)
  209.         extracting  a range  of values  from  each. Using  the /E  switch
  210.         Read_WKS will place all of this data  into a single file. You can
  211.         then "import" this  file containing  consolidated data from  many
  212.         (perhaps hundreds) of files into your spreadsheet or database.
  213.  
  214.         If you wish to use  Read_WKS with AutoCAD, an additional AutoLISP
  215.         program  (TAB123.LSP)  is  available   to  create  tables  within
  216.         AutoCAD. You  can obtain -=Tab123=-  from the ACAD forum  on Com-
  217.         puserve, many BBS's, or from Mountain Software directly.
  218.  
  219.  
  220.         II.  A d d e n d u m
  221.         ====================
  222.  
  223.         Error Messages
  224.         --------------
  225.  
  226.         Unidentified file format
  227.  
  228.              The file signature does not match a known file type.
  229.  
  230.         Cannot open file XXXX
  231.  
  232.              Reason: Misspelled filename or possible disk error.
  233.  
  234.         Unknown switch => X <=
  235.  
  236.              An  unknown   DOS  command   line  switch   was  passed   to
  237.              READ_WKS.EXE.
  238.  
  239.         Out of memory
  240.  
  241.              READ_WKS requires about 120K to run. 
  242.  
  243.         Unidentified Cell. OpCode = XXh Length = XX
  244.  
  245.              Usually caused by  processing a spreadsheet file  format not
  246.              known by READ_WKS.EXE.
  247.  
  248.         Unexpected end of input file
  249.  
  250.              The  end of  the file was  reached before  the end   of file
  251.              record was read.
  252.  
  253.         Error reading input file
  254.         Error writing to output file
  255.  
  256.              A disk error during a read or write operation occurred.
  257.  
  258.  
  259.         Read_WKS Documentation                                     page 6
  260.         =================================================================
  261.  
  262.  
  263.         Liability
  264.         ---------
  265.  
  266.         Careful  testing  has been  made  to ensure  that  these programs
  267.         perform  correctly. No  liabilities  are assumed  in  the use  or
  268.         misuse of this program  resulting in data  loss or damage. It  is
  269.         the  users responsibility  to be  sure  that the  results are  as
  270.         expected.
  271.  
  272.  
  273.         Author
  274.         ------
  275.  
  276.         If you have any suggestions or comments, please contact me.
  277.  
  278.         Jerry Workman, PE
  279.         1579 Nottingham Rd.
  280.         Charleston, WV 25314 
  281.         CIS 70717,3564
  282.         Internet 70717.3564@compuserve.com
  283.         Orders: 1-800-2424-PsL
  284.         Tech Support: 304-346-9585
  285.         FAX 304-744-1785
  286.  
  287.         Copyright 1991-93 by Mountain Software All rights reserved 
  288.  
  289.  
  290.         III. L i c e n s e
  291.         ==================
  292.  
  293.  
  294.         Shareware
  295.         ---------
  296.  
  297.         This version of  Read_WKS is NOT public domain  or free software,
  298.         but is  being distributed as "shareware".  You may try it  out to
  299.         see if  it is  useful for  you. If  you wish  to continue  to use
  300.         Read_WKS you must register. Registered  users are provided with a
  301.         password to  remove the  opening delay and  with support  for one
  302.         year.
  303.  
  304.         The program in the form of the original archived file only may be
  305.         freely distributed, but not sold  (except under license, or for a
  306.         nominal copying or disk fee).
  307.  
  308.         Non-registered users of  this software are  granted a limited  30
  309.         day license  to make  an evaluation  copy for  trial use  for the
  310.         purpose of  determining whether  Read_WKS is  suitable for  their
  311.         needs.  At the end of this  trial period, you may either register
  312.         your copy, or discontinue using Read_WKS.
  313.  
  314.         All users are granted a limited license to copy Read_WKS only for
  315.         the trial  use of  others and subject  to the  above limitations.
  316.  
  317.  
  318.         Read_WKS Documentation                                     page 7
  319.         =================================================================
  320.  
  321.  
  322.         This license  does NOT  include distribution  or copying of  this
  323.         software for use:
  324.  
  325.         1.   In connection with any other product or service.
  326.         2.   For general use within a company or institution.
  327.         3.   For distribution in modified form; i.e., the file containing
  328.              this license information  MUST be  included, along with  the
  329.              full Read_WKS documentation.
  330.  
  331.         Operators of  electronic  bulletin  board  systems  (Sysops)  are
  332.         encouraged to post Read_WKSxx.ZIP for downloading by their users,
  333.         as long as these conditions are met.
  334.  
  335.  
  336.         Registration Information
  337.         ------------------------
  338.  
  339.         A  Read_WKS registration  licenses you  to use  the product  on a
  340.         regular basis. Individual  license cost for Read_WKS is $30 which
  341.         includes a diskette  with the latest version of  Read_WKS and the
  342.         printed manual. West  Virginia residents should include  6% sales
  343.         tax.  The file  ORDER.DOC contains an  order form  and additional
  344.         ordering information.
  345.  
  346.         Educational institutions, full-time  students and BBS sysops  can
  347.         apply a 50% discount. PLEASE include your educational institution
  348.         letterhead (with your title), or  a photocopy of your most recent
  349.         registration slip, or the name and number of your BBS.
  350.  
  351.  
  352.         Definition of Shareware
  353.         -----------------------
  354.  
  355.         Shareware  distribution  gives  users a  chance  to  try software
  356.         before buying  it. If  you try a  Shareware program  and continue
  357.         using  it,  you  are expected  to  register.  Individual programs
  358.         differ  on  details  -- some  request  registration  while others
  359.         require  it,   some  specify   a  maximum   trial  period.   With
  360.         registration, you get anything from the simple  right to continue
  361.         using the software to an updated program with printed manual.
  362.  
  363.         Copyright laws apply  to both Shareware and  commercial software,
  364.         and the copyright holder retains  all rights, with a few specific
  365.         exceptions as  stated below.  Shareware authors  are accomplished
  366.         programmers, just like  commercial authors, and the  programs are
  367.         of comparable quality.  (In both cases,  there are good  programs
  368.         and  bad  ones!)  The  main   difference  is  in  the  method  of
  369.         distribution. The author  specifically grants  the right to  copy
  370.         and distribute  the software, either  to all and  sundry or  to a
  371.         specific group. For example, some authors require written permis-
  372.         sion before a commercial disk vendor may copy their Shareware.
  373.  
  374.  
  375.         Read_WKS Documentation                                     page 8
  376.         =================================================================
  377.  
  378.  
  379.         Shareware is a  distribution method, not a type  of software. You
  380.         should  find  software  that  suits  your needs  and  pocketbook,
  381.         whether it's commercial or Shareware.  The Shareware system makes
  382.         fitting your  needs easier, because  you can try before  you buy.
  383.         And because the  overhead is low, prices are  low also. Shareware
  384.         has the  ultimate money-back  guarantee -- if  you don't  use the
  385.         product, you don't pay for it.
  386.  
  387.  
  388.         Disclaimer - Agreement
  389.         ----------------------
  390.  
  391.         Users  of  Read_WKS  must  accept  this disclaimer  of  warranty:
  392.         "Read_WKS is  supplied as is.   The author disclaims  all warran-
  393.         ties, expressed  or implied, including,  without limitation,  the
  394.         warranties of merchantability and of fitness for any purpose. The
  395.         author assumes no liability for damages, direct or consequential,
  396.         which may result from the use of Read_WKS."
  397.  
  398.         Read_WKS is a "shareware program" and is provided at no charge to
  399.         the user  for  evaluation.   Feel  free  to share  it  with  your
  400.         friends, but please  do not give  it away altered  or as part  of
  401.         another system.  The  essence of "user-supported" software is  to
  402.         provide personal  computer users  with  quality software  without
  403.         high  prices,  and yet  to provide  incentive for  programmers to
  404.         continue  to develop  new products.    If you  find this  program
  405.         useful  and find that you are  using Read_WKS and continue to use
  406.         Read_WKS  after  a reasonable  trial  period,  you  must  make  a
  407.         registration  payment  of $30  to  Mountain  Software.   The  $30
  408.         registration fee will license  one copy for use  on any one  com-
  409.         puter at  any one time.  You must treat this software just like a
  410.         book.  An example is that this software may be used by any number
  411.         of people  and may be freely moved  from one computer location to
  412.         another, so long as  there is no possibility of it  being used at
  413.         one location  while it's  being used at  another. Just as  a book
  414.         cannot be read by two different persons at the same time.
  415.  
  416.         Commercial  users of  Read_WKS must  register and  pay for  their
  417.         copies of Read_WKS  within 30 days of first  use or their license
  418.         is withdrawn.   Site-License arrangements may be  made by contac-
  419.         ting Mountain Software.
  420.  
  421.         Anyone distributing Read_WKS  for any  kind of remuneration  must
  422.         first  contact  Mountain  Software  at   the  address  below  for
  423.         authorization. This  authorization will be  automatically granted
  424.         to distributors  recognized  by  the (ASP)  as  adhering  to  its
  425.         guidelines for  shareware distributors, and such distributors may
  426.         begin  offering Read_WKS  immediately (However  Mountain Software
  427.         must  still  be advised  so  that  the  distributor can  be  kept
  428.         up-to-date with the latest version of Read_WKS.).
  429.  
  430.  
  431.         Read_WKS Documentation                                     page 9
  432.         =================================================================
  433.  
  434.  
  435.         You are  encouraged to  pass a  copy  of Read_WKS  along to  your
  436.         friends for evaluation.  Please  encourage them to register their
  437.         copy if they find that they can use it. 
  438.  
  439.         Jerry Workman  a member of  the Association of  Shareware Profes-
  440.         sionals (ASP).  ASP wants to  make sure that the  shareware prin-
  441.         ciple works  for you. If you  are unable to  resolve a shareware-
  442.         related  problem with  an  ASP member  by  contacting the  member
  443.         directly, ASP may be able to help. The ASP Ombudsman can help you
  444.         resolve  a dispute or  problem with an  ASP member,  but does not
  445.         provide technical support for members'  products. Please write to
  446.         the  ASP Ombudsman at 545 Grover Road, Muskegon MI 49442, or send
  447.         a message via Compuserve mail to ASP Ombudsman 70007,3536
  448.  
  449.  
  450.         Trademark
  451.         ---------
  452.  
  453.         Mountain  Software   and  Read_WKS  are  trademarks  of  Mountain
  454.         Software.  MS-DOS  is a  registered  trademark of  Microsoft Cor-
  455.         poration. PC-DOS is  a registered  trademark of IBM  Corporation.
  456.         AutoCAD is  a registered trademark of AutoDesk.  123 and Symphony
  457.         are registered trademarks of Lotus Development Corporation
  458.  
  459.  
  460.         Read_WKS Documentation                                    page 10
  461.         =================================================================
  462.  
  463.  
  464.         IV.  I n d e x
  465.  
  466.  
  467.              123 . . . . . . . . . . . . . . . . . . . . . . .  3, 9
  468.              ACAD  . . . . . . . . . . . . . . . . . . . . . .  3, 5
  469.              ASP . . . . . . . . . . . . . . . . . . . . . . .  8, 9
  470.              AutoCAD . . . . . . . . . . . . . . . . . . . . 3, 5, 9
  471.              Command . . . . . . . . . . . . . . . . . . . . .  3, 5
  472.              Compuserve  . . . . . . . . . . . . . . . .  1, 5, 6, 9
  473.              directory . . . . . . . . . . . . . . . . . . . .  3, 5
  474.              disk  . . . . . . . . . . . . . . . . . . . . .  3, 5-7
  475.              DOS . . . . . . . . . . . . . . . . . . . . . .  3-5, 9
  476.              error . . . . . . . . . . . . . . . . . . . . . . . . 5
  477.              Excel . . . . . . . . . . . . . . . . . . . . . 1, 3, 4
  478.              file  . . . . . . . . . . . . . . . . . . . . . . . 3-7
  479.              filename  . . . . . . . . . . . . . . . . . . . . . 3-5
  480.              license . . . . . . . . . . . . . . . . . . . . . . 6-8
  481.              LISP  . . . . . . . . . . . . . . . . . . . . . . . . 3
  482.              Lotus . . . . . . . . . . . . . . . . . . .  1, 3, 4, 9
  483.              range . . . . . . . . . . . . . . . . . . . . . . . 3-5
  484.              range name  . . . . . . . . . . . . . . . . . . . . . 4
  485.              shareware . . . . . . . . . . . . . . . . . . .  1, 6-9
  486.              table . . . . . . . . . . . . . . . . . . . . . . . . 2
  487.              worksheet . . . . . . . . . . . . . . . . . . . 1, 3, 4
  488.              ZIP . . . . . . . . . . . . . . . . . . . . . . . . . 7
  489.